home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / cli / Pip.lha / pip.doc next >
Encoding:
Text File  |  1992-07-16  |  4.6 KB  |  141 lines
  1.                         Pip 1.0 
  2. Written By Asher Feldman
  3.  
  4. Pip allows you to easily pipe commands through each other, just as in Unix. For
  5. example, you could type a program in hexidemal (with the type opt h function)
  6. and have the output appear in more, or your favorite text reader. The Amiga
  7. comes with a pipe facility, the pipe: device. But, to make use of it, the user
  8. is required to enter multiple command lines, which is time consuming. Pip is a
  9. "user friendly" pipe utility, that does all the hard work automaticly for you,
  10. making the process quick and easy, as it is in Unix. 
  11.  
  12. Note!
  13. -----
  14.  
  15. Pip requires the pipe: device be mounted. It is automaticly mounted in the
  16. default startup-sequence, so if you haven't changed that, don't worry.
  17.  
  18. Because of the nature of the pipe: Pip will NOT work with programs that attempt
  19. to load file non-sequentially. If you are unsure about a program, just
  20. experiment with it!
  21.  
  22. Usage 
  23. -----
  24.  
  25. Pip is relativly easy to use. The usage is
  26.  
  27.     Pip [-s] <command1> | <command2>
  28.  
  29. <command1> may actualy contain upto 5 words, such as "type opt h prog" (without
  30. the quotes, of course.) The same is true for <command2>. The '|' character is
  31. used to seperate the two commands. It is the character above the '\' on your
  32. keyboard. 
  33.  
  34.     [-s] is optional. It will allow the piped output be in a form that allows
  35.     programs that must have a file name (as opposed to a redirection file,
  36.     which is what Pip normaly uses) to access the information. This will allow
  37.     you to, for example make the piped output go directly into a text editor.
  38.  
  39.     <command1> is the program to be run
  40.     <command2> is the program <command1> will be piped to.
  41.  
  42. For example, if I wanted to read Pip in hexidemal, but have the output appear in
  43. less, where I can move arround in two directions, and search for strings I would
  44. enter :
  45.  
  46.     Pip type opt h pip | less
  47.  
  48. If you weren't using Pip, you would have to enter the following into you CLI :
  49.  
  50.     run type >pipe: opt h pip   (Note that without the run you would have
  51.     run less <pipe:           to open a seccond cli to finish.)    
  52.  
  53. As you can see, it is much easier and quicker to use Pip. 
  54.  
  55. If I wanted to see the entire contents of DH0: in less, where you can search for
  56. files, or just browse, etc.. You would enter:
  57.  
  58.     Pip ls -lR dh0: | less
  59.  
  60. If you wanted the output to be able to appear in a file editor you could enter
  61. the following (Ed shall be used for this example, as it's standard)
  62.  
  63.     Pip -s ls -lR dh0: | ed
  64.  
  65. Note, that the -s option is required when <command2> expects the output in the
  66. form as a file (i.e. ram:file). If you are having trouble getting a program to
  67. recieve output, you should try using the -s option.
  68.  
  69. Ls is an excelent 2.0 only directory lister. With different programs, the
  70. context will be diferent. 
  71.  
  72.  
  73.                                  *     *     *
  74.  
  75.  
  76. Limitations
  77. -----------
  78.  
  79. Pip will only except 5 seperate words per command. Any more shall be cut off.
  80. Therefor, if you typed :
  81.  
  82.     Pip -s command opt a b c d | prog -a -b -c -d -e 
  83.  
  84. only the following would actualy be used:
  85.  
  86.     Pip -s command opt a b c | prog -a -b -c -d
  87.  
  88. Note, that the 'd' in the first command, and the '-e' in the seccond command
  89. have been cut off. I figured that 5 words would be enough, but if you disagree,
  90. please contact me at one of the adresses at the bottom of this file, as it is
  91. easy enough to expand the number of excepted arguments. Note, that the -s option
  92. does not count as a word.
  93.  
  94.  
  95. How To Contact Me
  96. -----------------
  97. Send bug reports/comments, etc.. to:
  98.  
  99. PORTAL: Wizard0
  100. INTERNET: asher@netcom.netcom.com
  101.           Wizard0@cup.portal.com
  102.  
  103. US Snail:
  104.  
  105.    Asher Feldman
  106.    4791 Calle de Tosca             Phone:  (408) 266-7917
  107.    San Jose, CA 95118
  108.  
  109. If you find this program useful, and would like to help out a poor high
  110. school student (as well as a die-hard Amiga user!) then I would greatly
  111. appreciate it if you sent a small amount of money, or maybe a nice euro
  112. demo to the address above.  I would be even MORE grateful if you sent me a
  113. 1.2GIG hard drive or a v.32bis modem! :-)
  114.  
  115. And Now For The Legal Claptrap
  116. -------------------------------
  117. If this program causes your computer to blow up, or your hard drive to
  118. implode, or anything else that isn't too nice, then it's your fault, not
  119. mine.  This program is not "guaranteed" to do anything. (although if it
  120. doesn't, please send me (E)mail!)
  121.  
  122. This program may be freely distributed as long as this doc file is included.
  123.  
  124. And remember:
  125.  
  126.  
  127.  
  128.  ONLY  _   C_o m m o d o_r_e   _
  129.       /\\  l\\   /l ll //  \  /\\
  130.      /  \\ l \\ /ll ll(< __  /  \\    MAKES IT POSSIBLE!!!!
  131.     /--- \\l  \X ll ll \\_ll/--- \\
  132.    /______________________________\\
  133.  
  134.  
  135.                                                  A.F.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.